Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Sound Volume

GetMovieVolume

The GetMovieVolume function returns a movie's current volume setting.

pascal short GetMovieVolume (Movie theMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

The GetMovieVolume function returns an integer that contains the movie's current volume represented as a 16-bit, fixed-point number. The high-order 8 bits contain the integer part of the value; the low-order 8 bits contain the fractional part. Volume values range from -1.0 to 1.0. Negative values play no sound but preserve the absolute value of the volume setting.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can change a movie's current volume by calling the SetMovieVolume function, which is described in the previous section.